home *** CD-ROM | disk | FTP | other *** search
/ United Public Domain Gold 2 / United Public Domain Gold 2.iso / utilities / pu093.dms / pu093.adf / sectorama.doc.pp / sectorama.doc
Text File  |  1994-10-31  |  8KB  |  192 lines
  1. **************************************************************************
  2. *
  3. *                            SECTORAMA V1.1                               
  4. *
  5. *                          Disk Sector Utility                            
  6. *
  7. *                      By Talin a.k.a. David Joiner                       
  8. *
  9. *                                                                         
  10. *
  11. *  IMPORTANT NOTE: This program is freely copyable and distributable,     
  12. *
  13. *  courtesy of David Joiner and MicroIllusions. It is NOT Public Domain.  
  14. *
  15. *  All copyrights are reserved by the author. You may give copies of this 
  16. *
  17. *  program to anyone you wish but you may not sell it.                    
  18. *
  19. *                                                                         
  20. *
  21. **************************************************************************
  22. *
  23.     This program is designed to help Amiga users recover lost or damaged
  24. data from floppy or hard drives, or to repair a damaged volume.
  25.  
  26.               ***** The Obligatory Gratitude Clause *****
  27.  
  28.     If you like this program and find it useful and worthwhile, 
  29. you can do one of several things.
  30.     1) You can do absolutely nothing. That's OK.
  31.     2) If you are a developer, you can send be something you 
  32. have done or are working on. I would like that very much.
  33.     3) If you are not a developer, but have lots of neat public 
  34. domain software, you could send me something neat. Don't send me anything 
  35. pirated
  36. or I'll just erase it.
  37.     4) If all else fails send me a thank-you note or other 
  38. comments.
  39.  
  40.     My Address is:
  41.         David Joiner
  42.         17428 Chatsworth
  43.         Granada Hills, CA 91344
  44.  
  45.     Don't send me any money. I don't have time to run a 
  46. business, and it's really not worth the effort. I make enough money 
  47. writing other kinds of software (games, creative tools) and we just 
  48. aren't set up to market any kind of programming utilities (different kind 
  49. of tech support, etc).
  50.  
  51.     The reason this program was written is because I had six 
  52. hard-drive failures over the course of four months (three different 
  53. units, two different manufacturers) and several times got myself into 
  54. situations where I just HAD to recover a file from a completely scrambled 
  55. disk. Since none of the then-current sector editors would work with hard 
  56. drives, SECTORAMA was born.
  57.     Note that this is not a cracking program. I don't even know 
  58. how to write one of those (disk interfacing was never one of my areas of 
  59. interest, I'm basically a graphics and user-interface type).
  60.  
  61. One other note: Sectorama requires the font TOPAZ-11. Make sure this is
  62. in your current fonts directory or the program won't work.
  63.  
  64. **************************************************************************
  65. *
  66. * Version 1.1 Changes                                                     
  67. *
  68. **************************************************************************
  69. *
  70.  
  71. Bugs Fixed:
  72.     1. All Updates were writing to lowest partition, regardless 
  73. of what partition you were editing. This really munged one of my files, 
  74. and I hope no one else has suffered the same fate. BAD, BAD David! It's 
  75. fixed now.
  76.     2. Blocks with keys higher that 7FFF hex weren't being read 
  77.        in.
  78.     3. Open save file was attached to wrong menu item.
  79.  
  80. New Features (Because I have had yet another crash and needed them)
  81.  
  82.     1. The "Repair Directory" menu item will re-build the hash 
  83. table in a directory block by searching through the entire disk for 
  84. blocks that 'claim' to be children of that directory. The revised block 
  85. is not written to the disk, nor is a new checksum computed. To write the 
  86. disk, use the 'K' (checksum) and 'U' (update) commands. You can also 
  87. hand-edit the block before writing out.
  88.     2. The Compute Hash Function menu item now has a Menu Key 
  89. Equivalent (Amiga-H).
  90.     3. There is a "Write all" menu option which writes all the 
  91. data from the current block to the save file, then goes to the next data 
  92. block and does the same, etc., until the chain ends.
  93.  
  94. **************************************************************************
  95. *
  96. * Version 1.0 Instructions                                                
  97. *
  98. **************************************************************************
  99. *
  100.  
  101. How to use Sectorama:
  102.  
  103. from the CLI, type:
  104.  
  105.         Sec <device>
  106.  
  107.     Where <device> is df0:, df1:, dh0:, hd0:, or whatever. 
  108. SECTORAMA
  109. in it's current form should work with virtually any AmigaDOS device that
  110. has a block size of 512 bytes.
  111.     The program will open up a high-res interlaced screen and 
  112. displays what it thinks is the root block for that device. You will 
  113. notice that one of the longwords in the block is highlighted. The 
  114. highlighting can be moved around with the mouse or arrow keys, allowing 
  115. you to select any of the longwords in the block.
  116.     Other information about the current block is displayed 
  117. around the various parts of the screen, including block number, file name 
  118. (if applicable), track/cylinder number, driver name, unit number, etc.
  119. Not all of these fields are editable in the current version, and some
  120. never will be.
  121.     At the bottom of the page shows 10 numbers labeled 
  122. 'History'. This is a list of the last 10 sectors you looked at. In future 
  123. versions, you will be able to click on one of these and go to that 
  124. sector, but this feature is not implemented yet.
  125.     At the top right is a list of keyboard commands you can 
  126. enter:
  127.  
  128.     J) Jump - read in the sector number indicated 
  129.        by the contents of the currently selected longword.
  130.     R) Root - go to the root block.
  131.     P) Parent - go to this sector's parent, if possible.
  132.     C) Chain - go to the next sector on the hash chain, if 
  133.        possible
  134.     X) Extention - go to this block's extention block, if  
  135.        possible.
  136.     H) Header - go to the Header of this data block.
  137.     D) Data - Go to the next data block (if you are at the 
  138.        header block of a file, it goes to the first data block).
  139.     L) Show the results of the last sector search (see below)
  140.     E) Edit, in hex, the contents of the sector. you may type 
  141.        values in directly. ESCAPE key returns to normal mode.
  142.     A) ASCII Edit, same as Edit, but in ASCII rather than hex.
  143.     K) Compute new checksum for this block.
  144.     U) Update - write this block back to the disk. (note: must 
  145.        be a CAPITAL 'U').
  146.     W) Write the data portion of this block to the save file (
  147.        see below)
  148.  
  149.     Sector Search - 
  150.     The Sector search pull-down menu allows you to search the 
  151. entire volume, sector by sector, looking for certain criteria. The 
  152. criteria canbe:
  153.     1) Filename with wildcards.
  154.     2) Parent block.
  155.     3) Header block.
  156.  
  157.     Thus, you can search for all files that fit the pattern 
  158. "*.c", or all files that have a parent of 409. This is useful for finding 
  159. sectors that have become 'de-linked' from the AmigaDOS filing system.
  160.  
  161.     The output of the search looks just like a regular sector 
  162. filled with sector keys - you can use the JUMP command to go to any of 
  163. those keys. The result of the search is not destroyed by this action and 
  164. can be brought up later using the option 'Last Search'.
  165.  
  166.     Save File -
  167.         You can open a save file on another disk and 
  168. save the DATA PORTION of any sector onto it. Each write is appended onto 
  169. the last, thus if your file is TOTALLY trashed, you can at least get 
  170. parts of it back (the parts you can find).
  171.     Use the 'Open' pull down menu to open the file and the 
  172. 'Close' to close it. The 'W' key writes the current sector to the save 
  173. file.
  174.     I have not tested this function, so be careful with it.
  175.  
  176.     Verify and Repair -
  177.         These functions aren't finished yet. 
  178. Eventually they will perform DiskDoctor-like functions, except under 
  179. close user control.
  180.  
  181.     Compute Hash Function -
  182.     This pull-down menu allows you to type a file or directory 
  183. name, and it will set the position of the highlighted region based on the
  184. hash value of that name. Then, all you need do is hit 'J' (Jump) to go
  185. to the hash chain containing that block, and hit 'C' (Chain) until you
  186. get to the entry you want.
  187.  
  188.     Good Luck!
  189.                   ____
  190.                    /__ /-
  191.                   //-////\/
  192.